<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
   <meta name="GENERATOR" content="Mozilla/4.76 [en] (Windows NT 5.0; U) [Netscape]">
   <title>Draw Polymarker</title>
</head>
<body ONLOAD="if(parent.frames[&quot;&quot;])location=&quot;#nowhere&quot;; if(parent.frames[&quot;frm5&quot;])parent.frames[&quot;frm5&quot;].location=&quot;OpcodesHd.html&quot;">
<b><i><font face="Arial">Draw Polymarker</font></i></b>
<hr>
<p><font face="Arial Black"><font size=-1>Purpose</font></font>
<ul>The <b>Draw Polymarker</b> function draws a marker or a series of marker
glyphs.</ul>
<font face="Arial Black"><font size=-1>Syntax</font></font>
<br>&nbsp;
<center><table BORDER CELLPADDING=9 WIDTH="55%" BORDERCOLOR="#000000" >
<tr>
<td VALIGN=TOP WIDTH="19%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Opcode
format</font></font></font></td>

<td VALIGN=TOP WIDTH="16%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Opcode</font></font></font>
<p><font face="Arial"><font color="#FFFFFF"><font size=-2>[ASCII] (Hex)</font></font></font></td>

<td VALIGN=TOP WIDTH="28%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Operand
Format</font></font></font></td>

<td VALIGN=TOP WIDTH="38%" BGCOLOR="#000080"><font face="Arial"><font color="#FFFFFF"><font size=-2>Comments</font></font></font></td>
</tr>

<tr>
<td VALIGN=TOP WIDTH="19%"><font face="Arial"><font size=-2>Single-byte,
readable operand</font></font></td>

<td VALIGN=TOP WIDTH="16%"><font face="Courier New"><font size=-2>[M] (4D)</font></font></td>

<td VALIGN=TOP WIDTH="28%"><b><font face="Courier New"><font size=-2>[&lt;ws>]&lt;I<sub>Count</sub>>[&lt;ws>&lt;I<sub>Xi</sub>>,&lt;I<sub>Yi</sub>>]<sup>+</sup></font></font></b></td>

<td VALIGN=TOP WIDTH="38%"><font face="Arial"><font size=-2>Draws a series
of markers, absolute coordinates.</font></font></td>
</tr>

<tr>
<td VALIGN=TOP WIDTH="19%"><font face="Arial"><font size=-2>Single-byte,
binary operand</font></font></td>

<td VALIGN=TOP WIDTH="16%"><font face="Courier New"><font size=-2>[m] (6D)</font></font></td>

<td VALIGN=TOP WIDTH="28%"><b><font face="Courier New"><font size=-2>&lt;B<sub>Count</sub>>[&lt;US<sub>Ecount</sub>>][&lt;L<sub>Xi</sub>>&lt;L<sub>Yi</sub>>]<sup>+</sup></font></font></b></td>

<td VALIGN=TOP WIDTH="38%"><font face="Arial"><font size=-2>Polymarker,
relative coordinates</font></font></td>
</tr>

<tr>
<td>-</td>

<td><font face="Courier New"><font size=-2>(8D)</font></font></td>

<td><b><font face="Courier New"><font size=-2>&lt;B<sub>Count</sub>>[&lt;US<sub>Ecount</sub>>][&lt;S<sub>Xi</sub>>&lt;S<sub>Yi</sub>>]<sup>+</sup></font></font></b></td>

<td><font face="Arial"><font size=-2>Polymarker, relative coordinates</font></font></td>
</tr>
</table></center>

<ul><i>Count</i>&nbsp;&nbsp; The number of points to mark. When using the
binary operand form, a value of zero for <i>count</i> indicates that an
extended count value will follow. In the ASCII operand case, <i>count</i>
may be any value larger than zero.
<p><i>Ecount&nbsp;&nbsp; </i>When <i>count</i> is zero, a 2-byte extended
count follows, allowing for polymarkers of length 256 through 65,791 vertices
which are encoded as an integer (0 to 65,535).
<p><i>Xi,Yi</i>&nbsp;&nbsp; The <i>i<sup>th</sup> </i>point (in logical
coordinates) at which to place a marker glyph.</ul>
<font face="Arial Black"><font size=-1>Details</font></font>
<ul>The Draw Polymarker function allows you to mark a particular point,
or series of points, with a marker glyph or a series of glyphs. The glyphs
are rendered at the specified points based on the current settings of the
<b><a href="SetMkrGlyph.html">Marker
Glyph</a></b>, <b><a href="SetMkrSz.html">Marker Size</a></b>, <b><a href="SetVis.html">Visibility</a></b>
and <b><a href="SetColr.html">Color</a></b> attributes.</ul>
<font face="Arial Black"><font size=-1>Notes</font></font>
<ul>If a Polymarker with more than 65,791 points is desired, it must be
drawn by multiple <b>Draw Polymarker</b> opcodes, unless the readable ASCII
form of the command is used.</ul>
<hr>
<hr WIDTH="100%">
</body>
</html>
